home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / rlog_143.zip / REMOTLOG.DOC < prev    next >
Text File  |  1992-05-29  |  25KB  |  594 lines
  1.                          R E M O T E   A C C E S S
  2.  
  3.  
  4.                   L O G  R E P O R T I N G  P R O G R A M
  5.  
  6.  
  7.                             Sep. 1990 - 1992
  8.  
  9.  
  10.                                 REMOTLOG
  11.  
  12.    //////    /////  /      /  ///////  ///////   /        ///////  ///////
  13.    /     /   /      / /   //  /     /     /      /        /     /  /
  14.    //////    ///    /   /  /  /     /     /      /        /     /  /   ///
  15.    /     /   /      /      /  /     /     /      /        /     /  /     /
  16.    /      /  /////  /      /  ///////     /      ///////  ///////  ///////
  17.  
  18. The Program  - Remotlog
  19.  
  20.  
  21.         I developed Remotlog because when the announcement of RA was made and I
  22.         endeavored to switch from QuickBBS.  There was something missing.  I
  23.         could no longer use all my QBBS utilities.  After exhaustive efforts of
  24.         trying to get the implementation of my old program by its author, I
  25.         decided that it was time to do some coding.
  26.  
  27.         Here we have the finished product.  A full fledged RA log reporting
  28.         program.  This program is in no way crippled.  And never will be.
  29.  
  30.  
  31.  
  32.         RA is the registered product of Continental Software.
  33.         QuickBBS is the registered product of The QuickBBS Support Group or     
  34.         whatever it is now adays.
  35.  
  36.  
  37.         At present this program will function with RA version 1.1x.
  38.  
  39.         Do not attempt to use this program with any other software except RA
  40.         because it uses the file MESSAGES.RA, FILES.RA and several other RA     
  41.         specific files.  If it cannot find this file the program will abort in
  42.         error.
  43.  
  44.         The screens provided by this program are as the author thought you
  45.         the sysops would like to see.  If you feel the information is too much
  46.         or that there is not enough, or would even like to see some of the
  47.         information moved from one location to another part of the page or a
  48.         totaly different screen.  Please do not hesitate to let the author
  49.         know.
  50.  
  51.  
  52.  
  53.  
  54. Configuration of Remotlog
  55.  
  56.    This is exactly as it appears in the Configuration file.  If you haven't
  57.    unzipped it.  It would behove you to do so.  And use it.  RTFM is now in
  58.    effect.
  59.  
  60. ;-------------------------------------------------------------------------
  61. ;                       Remotlog Configuration file
  62. ;                        By Orland Carter 1:135/72
  63. ;-------------------------------------------------------------------------
  64. ;
  65. ;-------------------------------------------------------------------------
  66. ;               R E G I S T R A T I O N   I N F O R M A T I O N
  67. ;-------------------------------------------------------------------------
  68. ;         {______________________________}
  69. BoardName  Opa-Locka Tower
  70. ;         {____________________}
  71. SysopName  Orland Carter
  72. RegistKey  00000000000000000000
  73. ;
  74. ;-------------------------------------------------------------------------
  75. ; This is a required entry.  It tells the program the [path + filename] of
  76. ; the Log file to be processed.
  77. ; DEFAULT : SYSTEM.LOG
  78. ;-------------------------------------------------------------------------
  79. ;
  80. LogFile SYSTEM.LOG
  81. ;
  82. ;-------------------------------------------------------------------------
  83. ; This entry is not required if you are only running single line system.
  84. ; If you are running Multi-Line and want to delete or zip each lines separate
  85. ; log files then this is needed.  LINEINUSE ##.  Where ## is the line being
  86. ; processed by this configuration file.  ## range is 1..99
  87. ;-------------------------------------------------------------------------
  88. ;
  89. LineInUse 1
  90. ;
  91. ;-------------------------------------------------------------------------
  92. ; This option is required if you want REMOTLOG to process the file Xfers
  93. ; against the files counter for a good downloaded count.  The DEFAULT is
  94. ; NOFDLOGFILE  the other option is FDLOGFILE \.......\  where \..\ is the
  95. ; [Path + Filename] of the FD log file.
  96. ;-------------------------------------------------------------------------
  97. ;
  98. FDLogFile C:\Fd\Fd.Log
  99. ;
  100. ;-------------------------------------------------------------------------
  101. ; This option is required.  It tells the program what the Dos Shell entry
  102. ; of your External chat program is.  This must be the same case as the
  103. ; BBS writes it to the log file.  Required whether you have one or not.
  104. ; DEFAULT : FX-CHAT.EXE
  105. ;-------------------------------------------------------------------------
  106. ;
  107. ExternalChat FastChat.EXE
  108. ;
  109. ;-------------------------------------------------------------------------
  110. ; This option is required.  It tells the program what [path + filename]
  111. ; the output of the program should be placed in. *.asc/*.ans versions.
  112. ; DEFAULT : REMOTLOG
  113. ;-------------------------------------------------------------------------
  114. ;
  115. Outputfile c:\RA\Txt\Remotlog
  116. ;
  117. ;-------------------------------------------------------------------------
  118. ; This option is required.  It tells the program which color to place the
  119. ; background of the ansi screen in.
  120. ; DEFAULT : 40
  121. ;-------------------------------------------------------------------------
  122. ;
  123. Back 40
  124. ;
  125. ;-------------------------------------------------------------------------
  126. ; This option is required.  It tells the program what color the numbers
  127. ; displayed are.
  128. ; DEFAULT : 1;33
  129. ;-------------------------------------------------------------------------
  130. ;
  131. Numbers 1;33
  132. ;
  133. ;-------------------------------------------------------------------------
  134. ; This option is required.  It tells the program what color to use when
  135. ; highlighting the Beginning and Ending dates of the Log period.
  136. ; DEFAULT : 1;46;37
  137. ;-------------------------------------------------------------------------
  138. ;
  139. HighLight 1;46;37
  140. ;
  141. ;-------------------------------------------------------------------------
  142. ; This option is required.  It tells the program which color to use to
  143. ; restore the screen to "normal".
  144. ; DEFAULT : 0
  145. ;-------------------------------------------------------------------------
  146. ;
  147. Normal 0
  148. ;
  149. ;-------------------------------------------------------------------------
  150. ; This option is required.  It tells the program which color to use for
  151. ; Outlining the Box and Dividing lines of the output file.
  152. ; DEFAULT 1;34
  153. ;-------------------------------------------------------------------------
  154. ;
  155. Outline 1;34
  156. ;
  157. ;-------------------------------------------------------------------------
  158. ; This option is required.  It tells the program which color to use for
  159. ; all the text that is printed.
  160. ; DEFAULT 0;32
  161. ;-------------------------------------------------------------------------
  162. ;
  163. Text 0;32
  164. ;
  165. ;-------------------------------------------------------------------------
  166. ; This option is required.  It tells the program whether or not you wish
  167. ; the optional page of Multiline usage to be displayed.  The statistics
  168. ; will still be stored if the option is not selected.
  169. ; DEFAULT : NOMULTILINE
  170. ;-------------------------------------------------------------------------
  171. ;
  172. NoMultiLine
  173. ;
  174. ;-------------------------------------------------------------------------
  175. ; This option is required.  It telss the program what type of log file
  176. ; You are using.  Wether FD/COMPACT [Front Door type] or OPUS/EXPANDED.
  177. ; DEFAULT FD / COMPACT
  178. ;-------------------------------------------------------------------------
  179. ;
  180. COMPACT
  181. ;
  182. ;-------------------------------------------------------------------------
  183. ; This option is not required and at the descretion of the sysop.  Using
  184. ; This will cause another page to be displayed in addition to the current
  185. ; 2 or 3 pages that are already displayed.  This option is where the sysop
  186. ; Can have remotlog search the logfile for something specific and keep
  187. ; track of its occurrences.
  188. ; I.e. *01My_Name Carter      - This will cause remotlog to search the log
  189. ; file for all occurences of "Carter" it will accumulate and store the
  190. ; amount of time it finds it in variable 01.  When it displays it it will
  191. ; display "My_Name >>> ####" where # is amount of times the item was found
  192. ; Possible Variables are 00-29.  The 0 is significant.  The "*" is required
  193. ; There can be no spaces except to separate the Display item from the
  194. ; Search item.
  195. ; Format "*<Variable 00-29><Entry to Make in *.Ans/*.Asc file> <Search For>"
  196. ;         *00My_Name Carter
  197. ;-------------------------------------------------------------------------
  198. ;
  199. ;*00Graffitti_Wall  Grafn3.EXE
  200. ;*01JetFighter_Game Combat 1
  201. ;
  202. ;-------------------------------------------------------------------------
  203. ; These options are not required.  But they do provide you with a great
  204. ; amount of security.  For areas you do not want all your users to see.
  205. ; IE. Adult areas or Sysop areas.  (Message Areas)
  206. ; DEFAULT - NONE.  200 MAXIMUM ENTRIES.
  207. ;-------------------------------------------------------------------------
  208. ;
  209. NoShow  8
  210. NoShow 10
  211. NoShow 12
  212. ;
  213. ;-------------------------------------------------------------------------
  214. ; These options are not required.  But they do provide you with a great
  215. ; amount of security.  For areas you do not want all your users to see.
  216. ; IE. Adult areas or Sysop areas.  (File Areas)
  217. ; DEFAULT - NONE.  200 MAXIMUM ENTRIES.
  218. ;-------------------------------------------------------------------------
  219. ;
  220. NoFile  8
  221. NoFile 10
  222. NoFile 12
  223. ;
  224. ;-------------------------------------------------------------------------
  225. ; This option is not required.  It is used to Change the default Sealink
  226. ; protocol displayed in the 1st output page to a protocol of your choosing.
  227. ; REPLACESEA - Is the Search String for the new protocol.
  228. ; REPLACEDSP - Is the Actual Item to be displayed in the Output page.
  229. ;-------------------------------------------------------------------------
  230. ;
  231. ;ReplaceSea SEALink
  232. ;ReplaceDsp SEALink
  233. ;
  234. ;-------------------------------------------------------------------------
  235. ; This option is also not required.  It determines whether or not the local
  236. ; logons will be shown on the report output.  The DEFAULT for this option
  237. ; is show local logons.  Leave this option out for the default to take
  238. ; effect.
  239. ;-------------------------------------------------------------------------
  240. ;
  241. ;NoLocal
  242. ;
  243. ;-------------------------------------------------------------------------
  244. ; This option is also not required.  It activates or deactivates the
  245. ; Files.BBS downloaded files counter.  The count will be stored and added
  246. ; to the Files.BBS in the directory the file was taken from.  DEFAULT for
  247. ; This option is FILECOUNTER,     To deactivate use NOFILECOUNT
  248. ;-------------------------------------------------------------------------
  249. ;
  250. FILECOUNTER
  251. ;
  252. ;-------------------------------------------------------------------------
  253. ; This option is also not required.  It activates a chat record.  This will
  254. ; log all chats found in the log file to a file called REMOTLOG.CHT in the
  255. ; current directory.  The DEFAULT is CHATRECORD, all chats will be logged.
  256. ; The other option to disable the chat is NOCHATRECORD
  257. ; A file is created named REMOTLOG.CHT
  258. ;-------------------------------------------------------------------------
  259. ;
  260. CHATRECORD
  261. ;
  262. ;-------------------------------------------------------------------------
  263. ; This option is also not required.  It activates or Deactivates the log
  264. ; deleting option.  The DEFAULT is the log will be deleted every 10 days.
  265. ; The two options are DELETELOG ## (Where ## is days log should be kept.)
  266. ; and NODELETELOG.  When Zipping the file use DELETELOG ##.
  267. ;-------------------------------------------------------------------------
  268. ;
  269. DELETELOG 7
  270. ;
  271. ;-------------------------------------------------------------------------
  272. ; This option is also not required.  It activates or Deactivates the log
  273. ; deleting option for the Front End Mailer (Front Door)).  The DEFAULT is
  274. ; the fd log will be deleted with the RA log.
  275. ; The two options are DELETEFDLOG and NODELETEFDLOG.
  276. ; When Zipping the File use DELETEFDLOG.
  277. ;-------------------------------------------------------------------------
  278. ;
  279. DELETEFDLOG
  280. ;
  281. ;-------------------------------------------------------------------------
  282. ; This option is also not required.  It will determine whether or not the
  283. ; Log file actually gets deleted/zipped/shrunk and/or given an individual date
  284. ; for storage.  The zip method used is PKZIP.  any version.  The file will
  285. ; be moved while zipped.  The zipped name will be in the format RLMMDDYY.ZIP
  286. ; This option will not function if the Delete log option is disabled.
  287. ; Pkzip must be in the current directory or properly pathed.
  288. ; DEFAULT - NOZIPFILE           other otion is ZIPFILE and SHRINKFILE
  289. ;-------------------------------------------------------------------------
  290. ;
  291. SHRINKFILE
  292. ;
  293. ;-------------------------------------------------------------------------
  294. ; This tells remotlog which message area to post the statistics files
  295. ; generated to.  A value of 0 here would cause remotlog to not post the
  296. ; files to the message area.  But will still accumulate information in
  297. ; Them.  This option is REQUIRED.
  298. ;-------------------------------------------------------------------------
  299. ;
  300. MessageBoard 3
  301. ;
  302. ;-------------------------------------------------------------------------
  303. ; This option is not required and defaults to Off.  It will determine if
  304. ; Remotlog will log a copy of all BBS downloads out to a file.  This file
  305. ; will be called Remotlog.Dwn  IT will be appended to.  To activate this
  306. ; option the Keyword is DOWNLOADS
  307. ;-------------------------------------------------------------------------
  308. ;
  309. ;Downloads
  310. ;
  311. ;-------------------------------------------------------------------------
  312. ; This option is not required and defaults to off.  It determines whether
  313. ; or not REMOTLOG will log a copy of all users that access any of the
  314. ; doors that you use on your system.  It logs them all to a file called
  315. ; REMOTLOG.DRS.  It will also append if the file is not erased.  The file
  316. ; as with all others created will be posted to the message base to the
  317. ; sysop.  The word to activate this option is WHATDOORS
  318. ;-------------------------------------------------------------------------
  319. ;
  320. ;WhatDoors
  321. ;
  322. ;-------------------------------------------------------------------------
  323. ; This option is not required and defaults to off.  It determines whether
  324. ; or not REMOTLOG will log a copy of all users that access any of the
  325. ; questionaires that you have for your users.  It logs them all to a file
  326. ; called REMOTLOG.QST.  It will also append if the file is not erased. The
  327. ; file will be posted to the message base.  Option is QUESTIONAIRE
  328. ;-------------------------------------------------------------------------
  329. ;
  330. ;QUESTIONAIRE
  331. ;
  332. ;-------------------------------------------------------------------------
  333. ; This option is not required and defaults to off.  It determines wheter
  334. ; or not REMOTLOG will create separate files for each report Screen.  The
  335. ; files will be REMOTLO#.ASC/ANS.  Where # is 1 - 5 depending on the Page
  336. ; the report.  OPTION SPLITFILES.
  337. ;-------------------------------------------------------------------------
  338. ;
  339. ;SPLITFILES
  340. ;
  341. ;-------------------------------------------------------------------------
  342. ; This option is not required and default to off.  It determines whether
  343. ; or not the Files.BBS listings will be sorted.  The sort now respects non-
  344. ; Filename characters at anypoint in the file and will no longer sort them
  345. ; to the top.  OPTION:  NOSORT
  346. ;-------------------------------------------------------------------------
  347. ;
  348. ;NOSORT
  349. ;
  350. ;-------------------------------------------------------------------------
  351. ; This option is not required and defaults to off.  It determines whether
  352. ; or not Superlog will generate a message to those users that have dropped
  353. ; carrier on your system.  Filename is required and must contain at least
  354. ; one character. OPTION: DROPCARRIER <FILENAME>    , NODDROPCARRIER
  355. ;-------------------------------------------------------------------------
  356. ;
  357. DROPCARRIER DROPMESS.TXT
  358. ;
  359. ;-------------------------------------------------------------------------
  360. ; This option is not required and defaults to off.  It determines whether
  361. ; or not superlog will generate a message to those users who have uploaded
  362. ; to the system.  Filename is required to Post a message and it must at
  363. ; least contain 1 character.  Option: UPLOADMSG <filename> , NOUPLOADMSG
  364. ;-------------------------------------------------------------------------
  365. ;
  366. UPLOADMSG Upload.TXT
  367. ;
  368. ;-------------------------------------------------------------------------
  369. ; This option is not required and defaults to off.  It determines whether
  370. ; or not superlog will generate a message to those users who have just logged
  371. ; on to the system.  New Users.  Filename is required to post a message and it
  372. ; must at least contain 1 character.
  373. ; Option: NEWUSERMSG <filename>,NONEWUSERMSG
  374. ;-------------------------------------------------------------------------
  375. ;
  376. NEWUSERMSG NewUser.TXT
  377. ;
  378. ;-------------------------------------------------------------------------
  379. ; This option is not required and defaults to off.  It will let REMOTLOG
  380. ; know that you have a CDROM Drive and which one it is.  Given the differences
  381. ; between manufacturers of CDROM drives for computers and how they place
  382. ; files on them.  This option allows for easy and more simplistic handling
  383. ; of those.  OPTION: CDROM <Drive Number> <Drive Letter>\
  384. ; Where drive number is 0-9 to indicate the physical number of the CDROM
  385. ; drive.  Drive Letter is of course whatever the CDROM drive letter is.
  386. ; the "\" is required on the drive specs.
  387. ;-------------------------------------------------------------------------
  388. ;
  389. ;CDROM 0 L:\
  390. ;CDROM 1 M:\
  391. ;CDROM 2 O:\
  392. ;
  393. ;-------------------------------------------------------------------------
  394. ; This option is also optional and defaults to off.  It will give you a
  395. ; complete listing of all users that have dropped Carrier on your system
  396. ; and how many times to date that they have done so.
  397. ; This will be posted to the Sysop by REMOTLOG.
  398. ; OPTION : CUMULATIVE
  399. ;-------------------------------------------------------------------------
  400. ;
  401. CUMULATIVE
  402. ;
  403. ;------------------------------------------------------------------------
  404. ; This option is also optional and defaults to PKZIP -m.  It controls
  405. ; which program is used to archive the log files.  The program must be able
  406. ; to remove the logfile after archiving it however.
  407. ; Default is ARCHIVER PKZIP -m
  408. ; Option ARCHIVER
  409. ;------------------------------------------------------------------------
  410. ;
  411. ;Archiver Pkzip -m
  412. ;
  413. ;-------------------------------------------------------------------------
  414. ; This option is also optional and defaults to 0.  It controls how many
  415. ; times the user must have dropped carrier before they will be listed in
  416. ; cumulative Dropped/Lost Carrier listing.
  417. ; Default is MINIMUMTIME 0
  418. ; OPTION MINIMUMTIME ###
  419. ;-------------------------------------------------------------------------
  420. ;
  421. ;MINIMUMTIME 5
  422. ;
  423. ;-------------------------------------------------------------------------
  424. ; This option is also optional and defaults to 0.  It controls how many
  425. ; times the user must have dropped carrier before they will be sent a
  426. ; Dropped Carrier message.
  427. ; Default is MINDROPCARR 0
  428. ; OPTION MINDROPCARR ###
  429. ;-------------------------------------------------------------------------
  430. ;
  431. ;MINDROPCARR 0
  432. ;
  433. ;-------------------------------------------------------------------------
  434. ;          E N D    O F    R E M O T L O G . C F G   F I L E
  435. ;-------------------------------------------------------------------------
  436.  
  437.  
  438.  
  439.  
  440.  
  441. Supplied ANSI Code sequences
  442.  
  443. Number  Represents
  444. ------  ----------
  445. 0       All attributes off  (Normal Display)
  446.  
  447. 1       High Intensity (Bold)
  448.  
  449. 5       Sets Blink on
  450.  
  451. 7       Reverse Video on
  452.  
  453. 8       Concealed on (makes display invisible)
  454.  
  455. 30      Foreground      Black
  456.  
  457. 31                      Red
  458.  
  459. 32                      Green
  460.  
  461. 33                      Yellow
  462.  
  463. 34                      Blue on Color Monitor
  464.                         Underline on MonoChrome
  465.  
  466. 35                      Magenta
  467.  
  468. 36                      Cyan
  469.  
  470. 37                      White
  471.  
  472. 40      BackGround      Black
  473.  
  474. 41                      Red
  475.  
  476. 42                      Green
  477.  
  478. 43                      Yellow
  479.  
  480. 44                      Blue
  481.  
  482. 45                      Magenta
  483. 46                      Cyan
  484.  
  485. 47                      White
  486.  
  487.  
  488.  
  489.  
  490.  
  491. Hints about operation of this program
  492.  
  493.   There are several different things that you can do to get certain results
  494.   from this program.
  495.  
  496.    For example if you want to change the beging date of the report without
  497.    erasing the remotlog.dat file.  All you have to do is to edit the .DAT file
  498.    find the string that has the date in it and make it a null string.  When the
  499.    program starts up it will notice the date is missing and get the date from
  500.    the current system.log file.
  501.  
  502.    When reading the log file the program will not attempt to reposition pointers
  503.    if the last item in the log is that "REMOTLOG has checked the log."  Of      
  504.      course
  505.    the current session will be appended to the end of the logfile.
  506.  
  507.    By deleting the notations that REMOTLOG makes in the log file you can force
  508.    it to re-process the log file.
  509.  
  510.    The *##^^^^^^^^^ ___ option will accept hard spaces in the search for        
  511.      portion.
  512.    It is not restricted.
  513.  
  514.    Any bug reports, comments, or requested addition, deletions etc. may be sent
  515.    to Node 1:135/72.  or the addresses listed in the registration section.  I   
  516.      can
  517.    also be reached in the RA_UTIL echo.  Before you send me a
  518.    bug report if you are not registered and if you are.  Insure that you RTM
  519.    and read the configuration file comments before screaming bug report.  If you
  520.    send me netmail bug reports and are not registered do not wait for a netmail
  521.    reply.  It cost me money to send a net message back to you and you couldn't
  522.    find it to register.  All bug reports must contain a copy of Errors.log and
  523.    a summarized copy of your configuration file.  Meaning leave out all the     
  524.      lines
  525.    with a ";" in them.  Explain the bug in full detail.  If not I will simply
  526.    ignore it or send you a message indicating that I will take no action until
  527.    you can meet the bug report requirements.
  528.  
  529.  
  530. Credits
  531.  
  532.    The author, Orland K. Carter, would like to thank my beta testers of
  533.    this program that put up with the constant updates to the one program and
  534.    major overhaul of their configuration and data files.
  535.  
  536.    BETA Testers
  537.         Peter Janssens
  538.         John Barton
  539.         Arturo Batista
  540.         Daniel Johnston
  541.         Robert Taylor 
  542.         Alex Stuart
  543.         Larry Stultz
  544.         George Boudreau
  545.         Jason C. Everett
  546.         Paul Lewman
  547.         James Thompson
  548.         Dan Sjolseth
  549.    my thanks you for your patience, and help in beta testing this program.
  550.  
  551.  
  552. Registrations
  553.  
  554.    The cost to register REMOTLOG $20 + a donation if you wish.
  555.     Registrations will be sent to.
  556.  ________________________________________________________________________
  557. |Registration of REMOTLOG,                    Form 1.43, B.Date 29 MAY 92|
  558. |------------------------------------------------------------------------|
  559. |                                                                        |
  560. |SysopName                                                               |
  561. |Name of Sysop __________________________________________________________|
  562. |                                                                        |
  563. |Street Address__________________________________________________________|
  564. |                                                                        |
  565. |City/St/Zip   __________________________________________________________|
  566. |                                                                        |
  567. |BoardName                                                               |
  568. |Name of BBS   __________________________________________________________|
  569. |                                                                        |
  570. |Number of BBS __________________________________________________________|
  571. |                                                                        |
  572. |Node #        __________________________________________________________|
  573. |                                                                        |
  574. |Make all payments address to                                            |
  575. |  Orland K. Carter, REMOTLOG                                            |
  576. |  2850 N.W. 155 Terrace                                                 |
  577. |  Opa-Locka, FL  33054-2223                                             |
  578. |________________________________________________________________________|
  579.  
  580. Thank you for your support.
  581.  
  582.         Orland
  583.  
  584. Node 1:135/72   FIDONET
  585.      55:55/2    CAPNET
  586.      55:5004/0
  587.      55:420/0
  588.      55:420/8349
  589.  
  590. Thank you for your support.
  591.  
  592.         Orland
  593.  
  594.